Breaking Change

Definition / 释义

（软件开发）破坏性变更：指对接口（如 API、函数签名、数据格式、配置项等）做出的修改，会导致现有代码、集成或依赖方在不改动的情况下无法继续正常工作。常见于库/框架升级、协议或数据结构调整。（也可泛指“会破坏兼容性的大改动”。）

Pronunciation / 发音

/ˈbreɪkɪŋ tʃeɪndʒ/

Examples / 例句

This update includes a breaking change.
这次更新包含一项破坏性变更。

To avoid a breaking change, we kept the old API and introduced a new endpoint for the new behavior.
为避免破坏性变更，我们保留了旧的 API，并为新行为新增了一个端点。

Etymology / 词源

由 breaking（“打破、破坏的”）+ change（“改变、变更”）组成，字面意思是“会打破某些东西的改变”。在软件工程语境中，“breaking”通常特指打破向后兼容性（backward compatibility）的变更；该用法随着 API 设计、版本管理与“语义化版本”（Semantic Versioning, SemVer）实践而广泛流行。

Related Words / 相关词汇

• Backward Compatibility
• Deprecation
• Migration
• Versioning
• API
• Major Release
• SemVer
• Regression

Literary Works / 文学作品

• Semantic Versioning 2.0.0（语义化版本规范）：在说明版本号规则与兼容性时常讨论 breaking changes。
• The Rust Programming Language（《Rust 程序设计语言》）：在讲解版本演进、生态与兼容性时会提到 breaking changes。
• Kubernetes Documentation（Kubernetes 官方文档）：在版本升级指南与 API 弃用策略中频繁出现 breaking changes。